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I Note about this article 

A packaged version of this guide, for offline use, is available here [Not yet available] 

The goal of the AME project is to provide a stable and non-intrusive build of Windows 10, without sacrificing 
usability and Win32 compatibility for the majority of mainstream applications. This includes the avoidance and 
riddance of privacy infringing automated data collection services, central to Microsoft’s strategy for the Windows 
10 operating system. 

This page provides a complete step-by-step description of how AME images are mastered based on Windows 
10 build 1903 with minor proceeding updates, defining a complete documentation of this project. 

While large portions of this process have been automated using various scripts and Linux command line 
utilities, a large majority requires manual effort, with many of the steps often producing differing and sometimes 
non-predictable results from instance to instance, increasing the difficulty of this procedure. As such, sections 
where abnormal behavior may occur have been appropriately highlighted. 

It is also recommended that anyone attempting to reproduce the steps in this guide be moderately versed with 
Linux and consequently also not afraid of using the command line. 
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Firstly, you will need to grab a clean ISO of Windows 10 build 1903. This can be done from Microsoft’s website 
directly, or via the use of third party tools, such as the Microsoft Windows and Office ISO Download Tool. 

During installation, particularly the next few steps, it is necessary to disconnect your target machine from the 
Internet. Burn the image to a USB flash drive or attach it in your VM manager to boot the installation medium. A 
partition size of at least 32GB is required. 

You will be asked to provide a product key. 

When asked, use 2 b 87 n- 8 kfhp-dkv 6 r-y 2 c 8 j-pkckt , which is a Generic License key for Windows 10 Pro N 
RTM. If your hardware has already been activated with a legitimate key, or if you have acquired your own, 
please enter your key instead. This generic key does not activate Windows; rather, it only allows for the 
installation to continue. 

If you purchased your key from a third party, you may want to activate the key using a vanilla Windows 10 
Installation on your machine before proceeding with AME, as the key will be tied to your motherboard and 
unable to be used again. Third party sellers sometimes check for this so they can make more money by 
reselling the key if you did not use it within a short time from purchasing it. 

Post Install Procedure - After the initial installation perform the following steps: 

The installation and initial setup proceeds mostly normally, with the arguably placebo-trier toggles for privacy 
being disabled for good measure. It is again very vital to mention that no internet connection be 
established during the entire installation! 
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Video: Windows 10 Post Install 

During the initial post-install setup, select your default language, skip any network setup (it will ask twice, click no on the 
second prompt), and add a user as a local account. This user will be the user which does not have administrator privileges. 
The username can be anything you want, but on AME releases the username is simply "user". 


Extracting and Installing Updates 

Before further changing the operating system, we recommend installing Microsoft’s security updates. Both the 
Servicing Stack Update (SSU) and Cumulative Updates are required to properly install updates. The 
Cumulative Update includes all updates released since the initial release of 1903. This means that only the 
latest Cumulative Update is required to obtain updates included in prior Cumulative Updates. The correct SSU 
for the Cumulative Update package can be found in the "How to get this update" section of each Cumulative 
Update page. For a full list of update options, as well as updates proceeding this guide, follow the Microsoft link 
here. The latest AME release uses SSU KB4528759 in conjunction with Cumulative Update KB4528760. 

Proceed at your own risk when installing updates outside of the scope of this guide, as amelioration features 
with respect to privacy may be jeopardized. 

To install an update, use Microsoft’s Deployment Image Servicing and Management (DISM) tool. 

Firstly, extract the desired .cab file from the .msu files: 
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C:\> expand -F:* <.msu file> <dest> 

The SSU will need to be installed prior to the Cumulative Update, but the DISM command structure is identical. 
Just point to the correct .cab file. 

Copy the Windowsl0.0-KB4528759-x64 .cab and WindowslO . 0-KB45287 60_PSFX. cab files to the root Of the C: 

drive, or a location of your choosing, and run the following commands from an elevated command prompt: 

C:\> dism /online /add-package /packagepath=C:\Windowsl0.0-KB4528759-x64.cab 
Reboot before installing the Cumulative Update 
C:\> shutdown /r /t 0 
Continue by installing the Cumulative Update 

C:\> dism /online /add-package /packagepath=C:\Windowsl0.0-KB4528760-x64_PSFX.cab 

Once the Cumulative Update has finished installing, it will prompt for a reboot. Reboot a second time after 
Windows boots up. The last step concerning updates is to clear the Windows Update cache: 

C:\> dism /online /Cleanup-Image /StartComponentCleanup 

Sometimes the progress bar hangs in the command prompt; it will update if you type on the keyboard. Use 
the arrow keys since that will not put text on the screen. Cleaning up the cache currently takes longer than 
installing updates. 


Install the Media Feature Pack 

Adding the Media Feature Pack allows for the playback of some embedded HTML5 web videos. Firefox, for 
example, will misbehave if this particular content is attempted to be played, and will indicate to the user that the 
pack needs to be installed. Other media intensive applications are also affected. 

Download the Media Feature Pack from the Microsoft Software Download Service 

Firstly, extract the desired .cab file from the .msu file: 

C:\> expand -F:* <MFP .msu file> <dest> 

Copy the resulting . cab file to the root of the C: drive, or a location of your choice, then install offline update, 
again using an elevated command prompt: 
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C:\> dism /online /add-package /packagepath=<path to .cab> 


Cleaning-Up Basic Ul Elements 

Simplifying the Ul and removing extraneous visual features is one of the critical aspects of the amelioration 
process (as well as ensuring that certain subsequently damaged and/or non-responsive features are pulled 
from the interface). The following tasks need to be undertaken before the amelioration and ameliorate scripts 
are executed. Given the various extraneous and difficult to describe Ul elements to be navigated for these 
procedures, videos have also been added to help document these basic tasks. 

Note that although these tasks may appear simple, they need to be undertaken before the amelioration or 
ameliorate scripts are executed. 


Cleaning-up the Start Menu and Taskbar 

Windows 10 ships with very confusing and misguided functionality and features implemented by default in the 
taskbar. These can and should be removed manually, aiding in simplifying the Ul. Note that most of these 
features will be unavailable once the amelioration script is executed. The Start Menu tiles (application links) are 
being removed now, for this very reason. Attempting to remove them later may actually not work. 
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Video: Cleaning up the Start Menu and Taskbar 

Remove all tiles from the Start Menu and all links except for Windows Explorer from the taskbar. Set the taskbar to never 
combine and set the systemtray to show all icons. 


Install OpenSSH server (optional) 

Build 1903 of Windows 10 allows for native integration of an OpenSSH server, sanctioned by Microsoft, with the 
OpenSSH client coming pre-installed on Pro editions of the software. Installation of the server will be 
accomplished offline, using the manual steps described on the official project's github page: 

Enabling the SSH server will add an attack vector to your machine. Please keep this in mind when enabling 
this feature! 

Download the latest build of OpenSSH. For a list of the latest releases follow this link. 

(We used v8.i.o.opi-Beta at the time of this guide) 

Extract Contents Of the latest build tO C : \Program FilesXOpenSSH 

Make sure the binary location has Write permissions to just the SYSTEM and Administrator groups. 
Authenticated users should only have Read and Execute. 

In an elevated Powershell console, run the following: 
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C:\> powershell.exe -ExecutionPolicy Bypass -File install-sshd.psl 

Open the firewall for sshd.exe to allow inbound SSH connections: 

C:\> New-NetFirewallRule -Name sshd -DisplayName 'OpenSSH Server (sshd)' 

-Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22 

Changing the SSH port to a port above 40000 will provide a small increase in security while on public 
networks. 

Start sshd in an elevated command prompt: 

C:\> net start sshd 


Note that this will automatically generate host keys under %programdata%\ssh if they don't already exist. 
Because of this, we can't distribute AME with the server already enabled, as all of the computers with AME 
would have identical public and private keys for SSH. 

The sshd service should also be configured to auto-start at boot. In an elevated PowerShell window type: 
C:\> Set-Service sshd -StartupType Automatic 


Run Amelioration Script (Pre) 

At this stage we are ready to begin the amelioration process, which is structured into various phases due to the 
nature of Windows 10's self-updating and healing capabilities. The amelioration script, the Windows-side 
component of the AME process, is responsible for disabling services, applying individual registry hacks, 
modifying various configuration files, and installing software. Consequently, this script has both options to be 
executed before and after the proceeding deletion process. 

The script has been heavily commented to reasonably document each operation. 

Download the script: 


Windows 10 Amelioration script 

Windows-side component for the amelioration process, heavily 
commented for documentation purposes. 


/-\ 

Download 

v J 

BAT File 34 KiB [ SHA256 Sum ] 
Version 2020-03-06 


Run the ameiioration_ 2019 - 12 - 14 .bat as Administrator 

Once opened, run option 1 Pre-Amelioration from the main menu. This may take several minutes to 
complete. 
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The script will likely generate errors; this is fine, it is just unable to remove some of the built-in apps with 
PowerShell. 

Run option 3: User Permissions , which will open the netpiwiz GUI for configuring Windows user 
permissions: 

• Reset password for Administrator account 

• Double click user account, go to the Group Membership tab and select Standard User 

• Click OK when finished. You will be asked to sign out, click Yes. 

After logging back in, change the password of the default user. 

In an elevated command prompt, type the following: 

C:\> net user user * 


Run Ameliorate Script (Linux Required) 

To assure that our changes are permanent, we need to remove Windows Update and its self-healing ability. 
This cannot be done within the running system because of Windows file permissions and repair operations. 
Another operating system, preferably a Linux distribution, is required for this step. 

The Ameliorate script makes heavy use of filesystem fuzzing search operations to effectively find and remove 
all files classified under specific naming conventions by Microsoft and pipes these paths to delete commands. 
As noted above, modifying the Windows filesystem from Linux allows us the luxury of ignoring filesystem 
permissions and ensures that Windows cannot re-patch these files before we reboot. This process enables the 
complete deletion of all relevant binaries from the system. In addition to the removal process the script also 
generates a recovery script to restore all of the removed Windows files from backup. 

The script is written in bash, and commented to reasonably document various deleted components. 

Download the script: 


Linux Ameliorate script 

Linux-side component for the amelioration process, commented 
for documentation purposes. 


f > 

Download 

\ _ / 

SH File 14 KiB [ SHA256 Sum ] 
Version 2020-03-06 


Boot into Linux and mount your Windows drive. 

Place ameiiorate_i903_2020-0i-i8. sh in the root directory of your Windows drive, and execute it with root 
permissions: 

$ sudo ./ameliorate_1903_2020-01-18.sh 

The script will generate ten errors, two for OfficeHub and eight for MicrosoftEdge. This is due to permissions. 
This seems to be fine and neither of the programs can run. For unknown reasons, there are multiple copies 
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of Windows files all over the folder structure of Windows 10. The ones that actually run Microsoft Edge are 
successfully removed. 

Once the script has finished, boot back into Windows to continue. 


Run Amelioration Script (Post) 

Due to the deletion process, at this stage, Windows 10 lacks even basic software, such as a web browser or 
media player. This process installs the chocolatey package manager and a selection of basic sensible software. 

Once again, run the ameiioration_ 2019 - 12 - 14 .bat as Administrator and enable internet access. 

Run option 2 Post-Amelioration from the main menu. 


Setup Classic-Shell 

The amelioration process, with respect to the disabling and/or outright deletion of certain binaries, such as 
Cortana, cripples some Windows functionality which needs to be replaced. The Start Menu is left handicapped 
with disabled search functionality and a few non-functional app links. Thankfully there are open-source projects 
such as classic-shell, aiming to not only replace the Start Menu with a separate executable, but also to be more 
functionally similar to the Start Menu from Windows 7 or earlier. 

The following describes the steps to configure classic-shell to the state used in AME: 
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Video: Configuring Start Menu replacement Classic-Shell 

While most of these configurations are optional, we have tried to align classic-shell with sensible theming. These are the 
settings applied in the AME release. 

Enable: Show all settings, go to the Skin tab: 

■ Select Midnight from the skin drop-down menu 

■ Select More transparent from the Skin options 

Go to the Main Menu tab: 

■ Uncheck Show Metro apps (apps have been disabled) 

■ Uncheck Show recent Metro apps (see above) 

■ Set Max recent programs to is (or any other number you'd like) 

- Uncheck Enable hybrid shutdown for good measure 

Go to the Menu Look tab: 

- Check Override glass color (this is optional) 

■ Set Menu glass color to oooooo (or any other color you'd like) 
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Modify Windows 10 Explorer 


Microsoft has opted to ship an arguably very poorly designed Ul, in terms of ease of access and clarity, with 
Windows 10. The lack of any defined contrasts and the burying of useful elements, which have been obscured 
by a confusing ribbon system, is especially apparent in windows Explorer , a very frequented application. 


In light of this oidNewExpiorer is an excellent project to integrate. 

Old New Explorer 

Windows 10 shell extension which can undo "improvements" to 
file browsing made in newer Windows version. 


< \ 

Download 

v_ J 

RAR File 278 KiB [ Source/Mirror ] 
Version 1.1.8 


Do not run this application as administrator. It will prompt you 
Use the following settings: 


■ Click Install and follow the dialogs 

■ Uncheck everything 

Use classical drive grouping in This PC 
Use libraries; hide folders from This PC 
Use command bar instead of Ribbon 
Hide caption text in File Explorer windows 
Hide caption icon in File Explorer windows 
Show details pane on the bottom 

■ Appearance style set to Default style (Windows 7 style / 

■ Status bar style set to Default style (white) 

■ Check Show status bar 


- Check 

- Check 

- Check 

- Check 

■ Check 

■ Check 


skin style) 


Install and Configure Cygwin 

Get Cygwin, "a Unix-like environment and command-line interface for Microsoft Windows" from their website 
and install lynx with it, so that apt-cyg can be used to get additional packages for Cygwin. Since the 
Windows Subsystem for Linux (WSL) will be unavailable in AME, Cygwin is a great addition to the Windows 
desktop. It allows the use of bash natively, as well as various other ported Unix and Linux tools. 


https://ameliorated.info/documentation.html 


11/15 



9/7/2020 


Documentation - AME 


0 : 00 / 3:06 



Video: Install and configure Cygwin with apt-cyg 

This video covers the complete guide on how to install and configure Cygwin with apt-cyg, as well as other AME specific 
modifications. 

During the install, select all the default options until the Select Packages dialog is reached. 

Search for each of the following applications and mark them to be installed. Searching does not display a list of 
packages; instead, it shows the category that each application is in. To see the packages, you need to expand 
the category by clicking the plus symbol. The packages you should install are: lynx and nano 

Follow through the rest of the installation wizard normally. 

Move the provided .bashrc to c:\cygwinx64\home\user\ Create the user folder if it does not exist already. 
The provided bashrc file does not have the dot in front of it. You will have to rename it with cygwin: 

$ mv bashrc .bashrc 

To install apt-cyg type the following commands in an elevated Cygwin shell: 


$ lynx -source rawgit.com/transcode-open/apt-cyg/master/apt-cyg > apt-cyg 
$ install apt-cyg /bin 
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Run the latest hardentools from Security Without Borders 

Due to Windows 10's ongoing security fiasco and surfacing issues, not to mention AME's commitment to basic 
levels of security, certain functionality needs to be modified and/or accommodated for along those lines. In 
addition to the adjustments made by the amelioration script , Hardentools, an open-source project from 
Security Without Borders, provides an optimal inclusion. 

Run the latest executable with administrator privileges: 

1. Uncheck the Powershell and cmd.exe box (unless desired) 

2. Click Harden! 

3. Click OK when finished 


Set Application Defaults 

The application defaults for Windows 10 1903 can be set by using either the Windows Settings App, or by a 
more tedious, but more reliable manual process. The manual process was created due to the 1809 release of 
Windows 10 containing a feature regression which caused the Windows Settings App method for setting 
application defaults to be broken. The 1903 release of Windows 10 appears to have fixed this issue, but the 
manual guide is included as it is known to always set defaults successfully. 

Setting the default browser, Music player and Video player are relatively simple one-off changes which need to 
be done using the Windows Settings App. Open the Windows Settings App, click Apps, then under "Web 
browser" select Firefox, do the same for "Music player" and "Video player" only this time selecting VLC. 

For the rest of the defaults start by making empty files with the desired file type. You can use the bash script 
below to generate the files. For example, for gif files; right click the generated file gif. gif , click Properties, 
click the Change button next to "Opens with:", then navigate to the executable that you would like to handle that 
file type. 


create_empty_files.sh 

A simple bash script to generate empty files to set application 
defaults. 


/-\ 

Download 

v_/ 

SH File 192 Bytes [ SHA256 ] 
Version 2020-03-06 


File types 

• .doc - ONLYOFFICE Desktop Editors 

• .docx - ONLYOFFICE Desktop Editors 

• .gif -JPEGView 

• . f lac - VLC 

• . mkv -VLC 

• .pdf - ONLYOFFICE Desktop Editors/Firefox 
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• . pps - ONLYOFFICE Desktop Editors 

• .ppsx - ONLYOFFICE Desktop Editors 

• .ppt - ONLYOFFICE Desktop Editors 

• .pptx - ONLYOFFICE Desktop Editors 

• . xis - ONLYOFFICE Desktop Editors 

• .xisx - ONLYOFFICE Desktop Editors 

File Type Handler Locations 

• JPEGVieW- C:\ProgramData\chocolatey\lib\jpegview\tools\app\JPEGView.exe 

. ONLYOFFICE Desktop Editors - C : \Program Files\ONLYOFFICE\DesktopEditors\DesktopEditors.exe 

• VLC - C:\Program Files\VideoLAN\VLC\vlc.exe 


Setting the default wallpaper for desktop and lock screen 

Modifying the default Wallpaper 

The goal of this section is to demonstrate how to modify the default wallpaper on a system level, replacing 
and/or adding the default GUI selection. The commands in this section will require an elevated command 
prompt. 

First take basic permission ownership over the wallpaper you want to replace: 

C:\> takeown /f C:\Windows\Web\Wallpapen\Windows\img0.jpg 
Modify access control for the default wallpaper: 

C:\> icacls C:\Windows\Web\Wallpaper\Windows\img0.jpg /reset 
Replace the wallpaper with your own specified file: 

C:\> copy <your wallpaper> C:\Windows\Web\Wallpaper\Windows\img0.jpg 
After this, reboot, and go to settings => Personalization and select your wallpaper. 


Modifying the default Lock Screen Image 

The goal of this section is to demonstrate how to modify the default lockscreen image on a system level, 
replacing and/or adding the default GUI selection. The commands in this section will require an elevated 
command prompt. 

First enable the lock screen with a reg add command: 
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C:\> reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Personal 
ization" /v NoLockScreen /t REG_DWORD /d 0 /f 

Run to enable the lock screen image on the sign-in window: 

C:\> reg add "HKLM\SOFTWARE\Policies\Microsoft\Windows\System /v 
DisableLogonBackgroundlmage" /t REG_DWORD /d 0 /f 

Take basic permission ownership over the image you want to replace: 

C:\> takeown /f C:\windows\WEB\wallpaper\Screen\irngl00.jpg 

Modify access control for the default lock screen image: 

C:\> icacls C:\windows\WEB\wallpaper\Windows\imgl00.jpg /reset 

Replace the lock screen image with your own specified file: 

C:\> copy <your image> C:\Windows\WEB\wallpaper\Windows\imgl00.jpg 

After this, go to Personalization => lockscreen and select your image. It should now show your personal 
wallpaper as the first image from the selection (far left). 

To set the wallpaper to another image, only the registry edit and the copy commands will be needed as none 
of permissions need to be changed. 

This marks the end of the AME guide, if you have any questions or concerns please place a message in the 
group chat, otherwise enjoy using your ameliorated Windows 10 install. 
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